home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / languages / dde / _pc / h / magnify < prev    next >
Text File  |  1992-02-09  |  3KB  |  64 lines

  1. (* Title:    magnify.h
  2.  * Purpose:  Display and entry of magnification factors
  3.  *
  4.  *)
  5.  
  6. #ifndef __magnify_h
  7. #define __magnify_h
  8.  
  9. (* ---------------------------- magnify_select ----------------------------
  10.  * Description:  Display dialogue box to set magnification factors.
  11.  *
  12.  * Parameters:   int *mul, *div -- multiplication/division factors
  13.  *               int maxmul, maxdiv -- maximum mult/div factors
  14.  *               magnify_handler --  caller-supplied function
  15.  *               void *phandle --  handle passed to user function
  16.  * Returns:      void.
  17.  * Other Info:   Displays a template called "magnifier" (which must be one of
  18.  *               your loaded templates). Mul and div are the initial
  19.  *               values on the left and right of the ":" in the ratio shown
  20.  *               in the dialogue box. They are modified according to user
  21.  *               mouse clicks on the "arrow" icons. Proc (if non-null) is
  22.  *               called each time the magnification factor changes.
  23.  *               The template should have the following attributes:
  24.  *                   window flags -- moveable, auto-redraw
  25.  *                                   Advisable to have title icon with text
  26.  *                                   "magnifier" or similar
  27.  *                   icon #0 -- the multiplication factor icon
  28.  *                           -- should have indirected text flag set with
  29.  *                           -- text something like "999" and max length 4
  30.  *                           -- also advisable to have validation string
  31.  *                           -- "a0-9" (allowing numeric input)
  32.  *                           -- button type should be "writeable"
  33.  *                   icon #1 -- the division factor icon
  34.  *                           -- same as icon #0
  35.  *                   icon #2 -- the increase multiplication factor icon
  36.  *                           -- should have text flag set and contain the
  37.  *                           -- "up-arrow" character (like for scroll bars)
  38.  *                           -- button type should be "auto-repeat"
  39.  *                   icon #3 -- the decrease multiplication factor icon
  40.  *                           -- same as icon #2 except use "down-arrow" char
  41.  *                   icon #4 -- the increase division factor icon
  42.  *                           -- same as icon #2
  43.  *                   icon #5 -- the decrease division factor icon
  44.  *                              same as icon #3
  45.  *                   icon #6 -- (optional but advisable) a text icon placed
  46.  *                              between icons #0 and #1 as a separator
  47.  *                              eg. ":"
  48.  *
  49.  *               These icons can be arranged in the window however you wish
  50.  *               but a reasonable layout is like the "magnifier" dialogue
  51.  *               box in !Draw or !Paint. 
  52.  *
  53.  *) 
  54. type magnify_handler = ^procedure handler(p : pointer);
  55.  
  56. procedure magnify_select(var mul, _div : integer;
  57.                 var maxmul, maxdiv : integer;
  58.                 handler : magnify_handler;
  59.                 phandle : pointer); extern;
  60.  
  61. #endif
  62.  
  63. (* end magnify.h *)
  64.